home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / nettrek / readme.amiga < prev    next >
Text File  |  1995-08-01  |  9KB  |  234 lines
  1. IMPORTANT: please read README.FIRST before reading this.
  2. ALSO IMPORTANT: this file is way out of date.  I've updated it some,
  3.    but don't trust it.  README.FIRST is current.
  4.  
  5.                  Paradise Client V2.3p8+ for AmiTCP/Amiga.
  6.                               Amiga V1.00
  7.  
  8.     First Amiga client: Randell Jesup (jesup@cbmvax.commodore.com)
  9.    original DNet Port by ERic Mehlhaff (mehlhaff@soda.berkeley.edu)
  10.  DNet-Paradise/general Amiga work by Joe Rumsey (ogre@netcom.com)
  11.             (email on this version to ogre@netcom.com)
  12.  
  13.         DNet by Matt Dillon, additional work by ERic Mehlhaff.
  14.           Matt Dillon may have email. No-one seems to know.
  15.         
  16.  
  17. Other sources of info
  18. ---------------------
  19. Usenet News: 
  20.     rec.games.netrek
  21. Netrek home page (please read the FAQ before asking on r.g.n!)
  22.     http://factoryx.factoryx.com/
  23. Paradise source(does not have complete Amiga source!), other stuff: 
  24.     ftp.cs.umn.edu:/users/glamm/paradise
  25. Source code for this client (only):
  26.     ftp.netcom.com:/pub/og/ogre/games/amiga_netrek_src.lha
  27.  
  28. **********************************************************************
  29. None of the above parties make any sort of guarantee on this software.
  30. It is provided as is, USE AT YOUR OWN RISK.
  31. **********************************************************************
  32. This help file is guaranteed to be disorganized, sorry.
  33.   The client contains MYSTERY FEATURES!!!!  Because I haven't yet
  34. documented everything. (And probably never will)
  35. **********************************************************************
  36. As I write this (Aug. 1, 1995) it's been more than a year since I
  37. really did any work on this code.  I never documented some of it,
  38. and frankly I don't remember what changes are in it.  The .xtrekrc
  39. file(s) provided are good enough to get you going, and the usual Unix
  40. documentation (See the home page above) mostly applies here as well.
  41. **********************************************************************
  42.  
  43.   This archive should contain:
  44.  
  45. Netrek/   
  46.     AmiTCP_Netrek -- the executable.
  47.     README.AMIGA -- This file        
  48.     CHANGES -- Highly inaccurate.
  49.     .xtrekrc, .keymap, etc... -- several options files
  50.     .dictionary -- for the speech synthesizer, fixes for common
  51.            mispronunciations
  52.     graphics/
  53.         <a bunch of cursor files>
  54.     colorshipbitmaps/
  55.         4 files, by race.  IFF's, have a look. 16 colors.
  56.     colorbitmaps/
  57.         16 color bitmaps other than ships.
  58.     colorbits8/
  59.         8 color versions of the above.  more than 8 is not
  60.         practical on many Amigas.  (my own included!)
  61.     monoshipbitmaps/
  62.         Empty, stick regular paradise bitmap "albums" here.
  63.     sound/
  64.     iff sound effects.
  65.     libs/
  66.         iff.library -- very small (3k) shared library to be placed in
  67.                        libs:
  68.     fonts/
  69.     netrek.font - tracers.font, but contains the special graphics
  70.               chars many servers use in their MOTD's.  Install
  71.                   in fonts: to use.
  72.     netrek/6
  73.     tracers_bold.font - like netrek.font but bold and doesn't have
  74.               the graphics chars.
  75.     tracers_bold/6
  76.     
  77. requirements:
  78.   o 68020/68881 or better.  If you have something less, you are
  79.     probably better off with the old Bronco client.  The 
  80.     combination of AmiTCP and this client is very greedy.
  81.   o OS 2.x/3.x
  82.   o 2 megs ram.  If you have less than 3, you'll have to change some
  83.     defaults.  Hopefully the comments in .paradiserc will help you.
  84.     Some amount of Fast RAM is a definite plus.
  85.   o ixemul.library installed..available on AmiNet.  if not on it's own,
  86.     as part of GCC.  I forget which version - it will tell you at
  87.     startup if it can't find the version it needs.
  88.   o iff.library (included) in your libs: directory
  89.  
  90. -----Installation (Amiga end):----------------------------------------
  91.   assign netrek: to wherever you unarchived this.  Should probably add
  92. this to s:user-startup to avoid doing it every time. example:
  93.  
  94. Assign netrek: work:games/DNetrek
  95. copy libs/iff.library to libs:    (if you don't have it already.)
  96. copy fonts to fonts: all
  97. ----------------------------------------------------------------------   
  98.  
  99. That's it!  The Unix end has it's own readme.
  100.  
  101. If you're new to netrek in general,  try to find the FAQ.
  102. Also check out the metaserver with
  103. telnet metaserver.ecst.csuchico.edu <port#>
  104. where <port#> is 3520-3525.  port 3521 is the most useful.
  105. There is also a European metaserver.  Read the normal metaserver's
  106. output for the address.
  107.  
  108. ----------------------------------------------------------------------
  109.   Running Netrek
  110.  
  111.   You *can* start Netrek from an icon.  I haven't provided one,
  112. and it doesn't process any tooltypes. It will run as if you ran it
  113. with no command line options.  What this means depends on what's in
  114. your .xtrekrc.  By default, this means it will connect to the
  115. metaserver.
  116.  
  117. Netrek -u  shows command line options.
  118.  
  119. The most basic way to start it is
  120.  
  121. Netrek -h <server> -p <port>
  122.  
  123. port can be left off if it's 2592, which most are.
  124.  
  125. server can be the full name or a nickname you have defined somewhere.
  126. I've included a bunch of nicknames in ".servers"  so you can type, for
  127. example, 
  128. Netrek -h bang
  129. to connect to bigbang.
  130. if you don't specify any server,  it uses a "server:  <name>" entry
  131. from your startup file(s).
  132.   Also, I have a shell alias for logging me in with the characters I
  133. use.  Something like this:
  134.  
  135. alias ogre run netrek:Netrek -r netrek:.xtrekrc -C Ogre -P <p/w> -h
  136.  
  137.   so I can just type
  138.  
  139. Work:> ogre calvin
  140.  
  141. to connect as ogre on calvin.usc.edu.
  142.  
  143.   YOU MAY HAVE MULTIPLE COPIES RUNNING.  As many as you have memory
  144. for, so you can play somewhere while you're on the wait queue
  145. somewhere else.  I have my windows set to open the wait stuff on the
  146. Workbench screen,  and the netrek screen won't open until you're
  147. through the wait queue.  This conserves valuable chip memory.
  148.  
  149.   You can "Iconify" a session by typing ctrl-z.  Closes all windows
  150. and opens a nifty little "Icon" (a window) on the workbench.  It's a
  151. paradise Info Icon,  so you can still see a little of what's going on
  152. at the server.   Iconify may not be entirely safe.  You've been
  153. warned.
  154.  
  155.  
  156. ----------------------------------------------------------------------
  157. STOPPING Netrek
  158.  
  159.   If for some reason you can't quit normally,  send a ctrl-c break to
  160. Netrek and hopefully it will exit.  May need to do it twice, but
  161. not usually.  If you didn't "run" Netrek, you can just type ctrl-c
  162. in the shell window.  otherwise, type "status", find its process # on
  163. the list, then type "break <#>".
  164.  
  165. ----------------------------------------------------------------------
  166.  
  167. IF DNET IS GETTING LOTS OF PACKET ERRORS, but doesn't when you're not
  168. running netrek,  the problem is probably that you have an old amiga
  169. that can't deal with 8 colors and high speed serial.  Set it to 4
  170. colors by putting this in .paradiserc:
  171.  
  172. screen.depth: 2
  173.  
  174. --
  175. screen.mode:
  176.  
  177.   The default mode is my personal favorite,  and my windows file is
  178. set up with the best configuration I've found.  You might also try
  179. Productivity mode, and put the map window below the tactical instead
  180. of next to it.  You can use full-sized windows that way and see
  181. almost all of both windows at once.  The disadvantage is that your
  182. other windows will have to extend off the side of the screen.
  183.  
  184.    The tab key works just like a depth gadget for whatever window is
  185. active.  Useful if you accidentally hide something behind a window
  186. with no gadget.  I personally have a commodity that makes a 2 button
  187. click shove windows to the back, and alt-double click to front.  
  188.  
  189. ctrl-a enters a special config mode.  pressing 'X' in config mode
  190. saves the window positions/configurations to "netrek:.xtrekwindowsrc"
  191. which is in the usual .xtrekrc format, and read by a #include in my
  192. .xtrekrc.
  193.  
  194.   All sorts of Amiga options can be set, I hope I have them all listed
  195. in .xtrekrc.  If there's anything you need, and can't find it there,
  196. let me know.  Also look at .sounds for a list of sound effects you can
  197. have, and for speech stuff.  I turn most sounds off, so if you're just
  198. using my .sounds file, you're missing a bunch of 'em :-)  Sounds are
  199. in IFF format, replace them with whatever you like.
  200.   New sound menu! type ctrl-s.  Turning a sound off removes it from
  201. memory.  On does the reverse...
  202.  
  203.   The cursors in graphics/ are just regular amiga cursor files(which
  204. in turn are normal iff brushes!)  You can edit them too.  They're
  205. animated, # of frames determined by the highest sequentially numbered
  206. file.
  207.   There is an extra page on the options menu for Amiga stuff, sound,
  208. speech, autopoint, etc.  Shift-O  brings the options menu up,  first
  209. three pages are regular client stuff, the 4th has Amiga settings.
  210. ----------------------------------------------------------------------
  211.   There are still bugs!  Please report any you find, especially if you
  212. can repeat it.  (Well, it probably won't do you much good, I stopped
  213. active development on this ages ago )-:
  214.  
  215.   For non-Amiga stuff, any docs you can find for Paradise clients
  216. should apply.  Check the paradise ftp site.
  217. Netrek -f  shows the ftp site for normal Paradise stuff.
  218.  
  219. Any problems/questions/suggestions, mail me at
  220.  
  221. ogre@netcom.com
  222.  
  223. for Amiga related stuff.  For general Paradise stuff, try
  224.  
  225. paradise-workers@reed.edu
  226.  
  227. (I'm also on that list...)
  228.  
  229.   -Joe
  230.   "Ogre"
  231.  
  232.  
  233.  
  234.